18. Audio Commands > 18.11 AT^SNFG   Generate Tone

18.11
AT^SNFG   Generate Tone
The AT^SNFG write command generates a 'local tone' via the selected audio output device.
Beside the duration up to 3 combinations of frequency and amplitude can be used to compose a local tone.
Syntax
Test Command  
Response(s)
^SNFG:(list of supported <duration>s), (list of supported <frequency>s), (list of supported <amplitude>s)[, ...]
Write Command  
Response(s)
Reference(s) 
PIN 
ASC0 
ASC1 
USB 
MUX1 
MUX2 
MUX3 
Charge 
Last 

 
Parameter Description
 
in Milliseconds.
0...65535
 
0
Mutes the currently played tone immediately.
65535
Activates a tone with infinit duration.
 
in Hertz
200...3400
 
to be input in 1 Hz steps. Audible bandwidth is limited due to the voice band filters.
 
of the tone generator belonging to a frequency.
0...100
 
The output level at the speaker is dependent of the <outBbcGain> value (see AT^SNFO).
If more than one tone should be played, each amplitude level will be divided by the number of running tones to avoid overdriving of the internal amplifier. For example, if three tones with amplitude of 30 units should be gen­erated each amplitude is reduced to 10. Setting of amplitude to 100 corresponds with using of current <outB­bcGain> value (see AT^SNFO), 0 is mute.


Notes
•
•
If more than one pair of <frequency> and <amplitude> is used then the amplitude for each frequency is devided by the number of pairs.
•
Tone priorities
Ring tones (incoming call/short message), Supervisory tones,Call Progress tones, Battery tones, RTC tones and DTMF tones always have higher priority than a local tone. This means a local tone will be played only if no module tone with a higher priority is being played. A local tone will be stopped and ended when a tone or melody from the module starts to play.
•
•
Switching the tone generator on and off will trigger AT+CIND indicator "sounder" depending on current AT+CMER settings.
•